home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / packages / amslatex / read.me
Text File  |  1995-03-15  |  7KB  |  152 lines
  1. READ.ME file for AMS-LaTeX 1.2, 23-Feb-1995
  2.  
  3. [This file resides in the `amslatex' parent directory of the AMS-LaTeX
  4. distribution; for the moment, however, a copy is also placed in the
  5. `math' subdirectory to ensure that the READ.ME file is found on CTAN
  6. (pending resolution of some mirroring complications). 23-Feb-1995 mjd]
  7.  
  8. AMS-LaTeX is a collection of various extensions for LaTeX to provide
  9. support for sophisticated mathematical typesetting. It has been
  10. developed by the American Mathematical Society and released for general
  11. use as a service to the mathematical community. It is in many cases
  12. distributed at no extra charge with LaTeX, as well as being available
  13. through standard sources of TeX-related software such as the
  14. Comprehensive TeX Archive Network (CTAN) (addresses ftp.shsu.edu (USA),
  15. ftp.dante.de (Germany), ftp.tex.ac.uk (UK), and others). Technical
  16. support for AMS-LaTeX is provided by the AMS:
  17.  
  18.   American Mathematical Society
  19.   Electronic Products and Services
  20.   P. O. Box 6248
  21.   Providence, RI 02940
  22.   Phone: 800-321-4AMS (321-4267) or (USA/Canada) 401-455-4080
  23.   tech-support@math.ams.org
  24.  
  25. UPGRADING FROM VERSIONS 1.0, 1.1, OR 1.2beta
  26.  
  27. If you are upgrading from an earlier version of AMS-LaTeX, you will want
  28. to print and read diff12.tex, which describes the changes done for
  29. version 1.2. In particular, all LaTeX support that is concerned only
  30. with fonts in the AMSFonts collection has been moved to the AMSFonts
  31. distribution, and the amstex package has been succeeded by a package
  32. called amsmath (although a frozen copy of amstex.sty is provided for use
  33. with existing documents).
  34.  
  35. Instructions for using AMS documentclasses are no longer included in the
  36. `AMS-LaTeX User's Guide', amsldoc.tex. They are now found instead in
  37. instr-l.tex in the `classes' subdirectory (`Instructions for Preparation
  38. of Papers and Monographs: AMS-LaTeX'). This is a copy of the file
  39. instr-l.tex that is found in the author-info area of e-math.ams.org,
  40. which contains information pertaining specifically to the submission of
  41. LaTeX or AMSTeX documents to AMS publications.
  42.  
  43. INSTALLATION
  44.  
  45. To use version 1.2 of AMS-LaTeX it is necessary for you to have a recent
  46. version of LaTeX (June 1994 or later, "LaTeX2e"). If you're not sure
  47. about the version, look at the startup message that is printed on screen
  48. and in the TeX log when you run LaTeX. It should mention the LaTeX
  49. version number and date somewhere in the first ten lines. If your
  50. version of LaTeX is older than June 1994, we suggest getting the latest
  51. version from the Comprehensive TeX Archive Network (CTAN), directory
  52. tex-archive/macros/latex, ftp addresses as given above. If ftp file
  53. transfer is not an option for you, contact the source from which you
  54. originally obtained LaTeX. If you are unable for some reason to upgrade
  55. from version 2.09 of LaTeX, you could try using version 1.1 of
  56. AMS-LaTeX, which is available in a separate area (on e-math.ams.org:
  57. /pub/tex/amsltx11).
  58.  
  59. Files in the AMS-LaTeX distribution:
  60.  
  61.   amsldoc.tex     users' guide
  62.   amslatex.faq    frequently asked questions, with answers
  63.   amslatex.bug    history of reported bugs, bug fixes, and other changes
  64.   diff12.tex      description of differences between versions 1.1 and 1.2
  65.   technote.tex    some technical notes
  66.   testmath.tex    test file for general math features
  67.   subeqn.tex      test file for `subequations' environment
  68.   amslatex.ins    installation file for unpacking .dtx files
  69.  
  70.   amsbsy.dtx      for \boldsymbol and \pmb
  71.   amscd.dtx       for commutative diagrams
  72.   amsgen.dtx      auxiliary file
  73.   amsintx.dtx     alternative syntax for integrals, sums
  74.   amsmath.dtx     equations and other math
  75.   amsopn.dtx      for `operator names'
  76.   amstext.dtx     \text command
  77.   amsxtra.dtx     misc rarely used commands
  78.   amsdtx.dtx      document class for printing AMS .dtx files
  79.  
  80.   amsclass.dtx    source for amsart, amsproc, amsbook documentclasses
  81.   instr-l.tex     instructions on using AMS documentclasses
  82.   amsthm.dtx      provides \theoremstyle, \newtheorem*
  83.   upref.dtx       makes \ref always produce roman/upright numbers
  84.  
  85.   amsalpha.bst    AMS BibTeX style for alphabetic citation labels
  86.   amsplain.bst    AMS BibTeX style for numeric citation labels
  87.   mrabbrev.bib    BibTeX abbreviations for MR journal names
  88.   amsclass.ins    installation file for unpacking .dtx files
  89.   thmtest.tex     test file for amsthm package
  90.  
  91. Additional, more specific information on preparing a LaTeX document for
  92. submission to the AMS is found in the `author-info' area of the AMS ftp
  93. archive (e-math.ams.org).
  94.  
  95. PUTTING FILES IN A SUITABLE PLACE ON YOUR SYSTEM:
  96.  
  97. There are two `areas' (directories or folders) on your system that are
  98. involved in installing AMS-LaTeX: an AMS-LaTeX source files area, and a
  99. LaTeX input files area. All files in the `inputs' subdirectory of the
  100. AMS-LaTeX distribution should be placed in the LaTeX input directory or
  101. folder on your system. Consult your TeX documentation if you don't know
  102. where this is. (You could also try looking for the file article.cls; the
  103. place where you find it is almost surely your LaTeX input files area.)
  104. Some representative examples:
  105.  
  106. PC/DOS/emTeX:
  107.  
  108.   LaTeX input files area --- c:\emtex\latex\inputs
  109.   AMS-LaTeX source files --- c:\emtex\latex\packages\amslatex
  110.  
  111. Macintosh/Textures:
  112.  
  113.   LaTeX input files area --- Folder `TeX inputs' or bullet+`LaTeX'
  114.   AMS-LaTeX source files --- Folder `AMS-LaTeX' in `Textures' folder
  115.  
  116. Unix:
  117.  
  118.   LaTeX input files area --- /texmf/tex/latex/inputs
  119.   AMS-LaTeX source files --- /texmf/tex/latex/packages/amslatex
  120.  
  121. All other files in the AMS-LaTeX distribution (the ones in the `math'
  122. and `classes' subdirectories) can be placed in an AMS-LaTeX source files
  123. area; if you are installing AMS-LaTeX on a new system, you may need
  124. to create a new folder or directory for this purpose.
  125.  
  126. TESTING
  127.  
  128. For a quick test of the installation, try printing the test file
  129. subeqn.tex. For more extensive tests print the AMS-LaTeX user's
  130. guide (amsldoc.tex) or testmath.tex.
  131.  
  132. NOTES FOR USERS OF AMS-LaTeX 1.1:
  133.  
  134. Some AMS-LaTeX 1.1 users whose TeX implementation has relatively limited
  135. memory capacities may not be able to use AMS-LaTeX 1.2. For example,
  136. there is an upper limit of 3500 control sequence names (hash size) in
  137. emTeX's tex286. This was marginally sufficient for LaTeX 2.09 +
  138. AMS-LaTeX 1.1, but is not enough for current LaTeX + AMS-LaTeX 1.2.
  139.  
  140. Support for LaTeX's `compatibility mode'---that is, reproducing exactly
  141. the same results as version 1.1 for existing documents that use
  142. \documentstyle instead of \documentclass---is incomplete. Most
  143. compatibility-mode documents should run through without error messages
  144. at least, but there will be some observable differences in the results.
  145.  
  146. ACKNOWLEDGMENTS
  147.  
  148. Many thanks to David M. Jones for contributing the changes needed in the
  149. amsmath package to support `flush-left equations' (the fleqn option),
  150. and for overhauling align, alignat, and related environments to fix a
  151. number of miscellaneous problems with equation number placement.
  152.